home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / basic / ace24dist.lha / ace24.lha / utils / ab2ascii-1.3 / ab2ascii.doc < prev    next >
Text File  |  1996-09-11  |  3KB  |  80 lines
  1.  
  2.      AmigaBASIC->ASCII                                        -*- Text -*-
  3.  
  4.      NAME
  5.           ab2ascii - generate ASCII source from AmigaBASIC binaries
  6.  
  7.      SYNOPSIS
  8.           ab2ascii [options] [-o|>] [outfile] [<] [infiles]
  9.  
  10.      DESCRIPTION
  11.           ab2ascii reads binary AmigaBASIC sources, expands tokens and
  12.           symbols and generates ASCII output.  Today there is need for
  13.           ab2ascii since AmigaBASIC does not run anymore under versions
  14.           of Kickstart V37+.  ab2ascii should do exactly the same as
  15.           the AmigaBASIC equivalent
  16.  
  17.                             SAVE "filename",A
  18.  
  19.           In fact many interresting AmigaBASIC programs have been
  20.           published in the past and they should not be lost.
  21.  
  22.           By default ab2ascii converts from the standard input stream
  23.           to the stdout, i.e. you can convert your binaries through
  24.           a pipe.  If any input filenames are given in the command line
  25.           these will be used instead of stdin.
  26.  
  27.           Input and output filename can NOT be the same.  However the output
  28.           filename can be given relative to the input filename by using
  29.           one `%s' construct in the ouput filename specification.  The first
  30.           occurence of `%s' will be replaced by the input filename.
  31.           A constant output filename makes no sense with more than one input
  32.           file because ab2ascii would replace this file each time a new input
  33.           file is converted.  To join several input files to one output file
  34.           the standard output stream can be used.
  35.  
  36.           White spaces between the option keywords and their values are
  37.           optional, i.e. `-ofile' and `-o file' are both legal, concatenation
  38.           of option keywords however is not:  -vh and -v -h result in a quite
  39.           different behaviour.
  40.  
  41.  
  42.           Further options are:
  43.  
  44.           -d#      Sets the debugging level.  (currently -d1 only)
  45.                    ab2ascii must be compiled w/ a symbol DEBUG defined to use
  46.                    this option.
  47.  
  48.           -E file  Directs error messages to `file' instead of the standard
  49.                    error stream 'stderr'.  Usefull for batchfiles
  50.  
  51.           -h       Displays a short usage information and option overview.
  52.  
  53.           -o fmt   Directs ASCII output to a file `fmt'.  The first `%s' in
  54.                    fmt (if any) will be replaced by the input filename.
  55.                    If the input is taken from stdin then `stdin' will be
  56.                    used to replace `%s'
  57.  
  58.           -v       Displays short author and version information
  59.  
  60.  
  61.      NOTES
  62.           ab2ascii will not check the existance of the output file.
  63.           If it exists ab2ascii will blow it away without asking you.
  64.           ab2ascii also assumes the existance of all dircetories in the
  65.           output path.
  66.  
  67.           For those who want to generate an ABASIC DOpus class:
  68.           AmigaBASIC binaries always start with a $F5 byte!
  69.  
  70.      AUTHOR
  71.           Tobias Ferber, Goethestraße 32, 76135 Karlsruhe
  72.  
  73.           Earn:      ukjg@dkauni2.bitnet
  74.           InterNet:  ukjg@ibm3090.rz.uni-karlsruhe.de
  75.  
  76.           Initial revision by Stefan Reisner, sr@ph.cip.uni-koeln.de
  77.  
  78.           Commodore Amiga BASIC Version 1.2 (Created  6 Oct 1986) is
  79.           Copyright (c) 1985, 1986 by Microsoft Corp.
  80.